home *** CD-ROM | disk | FTP | other *** search
/ Pascal Super Library / Pascal Super Library (CW International)(1997).bin / BBS_UTL / DDPLUS71 / MACROKEY.ZIP / MACROKEY.DOC next >
Text File  |  1995-03-14  |  4KB  |  90 lines

  1.                            A MACRO ROUTINES UNIT
  2.                               Copyright 1995
  3.                       By Scott M. Baker and Bob Dalton
  4.  
  5.                                INTRODUCTION:
  6.                                ------------
  7.           Sometimes you are going to want the option to allow the
  8.           recording of macro keys in your door program.  This unit
  9.           adds that function to the DDPlus package.  The MACROKEY.PAS
  10.           code included in this archive is FREEWARE and can be used in
  11.           any manner you want and without cost, but remains copyrighted
  12.           to Scott Baker.  The Macro Key routines portion of this
  13.           document remain copyrighted to Scott Baker. Everything else
  14.           is copyrighted by Bob Dalton. 
  15.  
  16.                                 REQUIREMENTS:
  17.                                 ------------
  18.           At this point in time the only requirements are that you must
  19.           be using Borland Turbo Pascal version 6.0 or 7.0.  I compiled
  20.           the unit with Borland Pascal 7.0 Professional and know it
  21.           works. I expect it will with TP 6.0 as well but can't guarantee
  22.           it.  You must also have already compiled the main DDPLUS.PAS
  23.           unit BEFORE compiling the MACROKEY.PAS.
  24.  
  25.                                 Files Included
  26.                                 --------------
  27.           Below is a listing of all files for the MACROKEY.ZIP Package:
  28.  
  29.           MACROKEY.DOC - The text file you are reading.
  30.           MACROKEY.PAS - The Macro Key routines unit by Scott Baker.
  31.  
  32.                     Installation and Preparation for Use
  33.                     ------------------------------------
  34.  
  35.          1. Move the archive package to a temporary directory and "unzip".
  36.  
  37.          2. Before compiling the MACROKEY.pas unit be sure that your
  38.             compiler knows where to find the listed units.
  39.  
  40.          3. Add MACROKEY to the "Uses" portion of your program and call
  41.             the procedures as needed.
  42.  
  43.          4.  That's it!  Enjoy and good luck.
  44.  
  45.   
  46.                          PROCEDURE INFORMATION
  47.                          ---------------------
  48.           
  49.           DISPLAY_MACRO(s: string);                        [OUT]
  50.  
  51.                This procedure is used to display a macro-string. The
  52.           macro string is usually contained in the variable
  53.           MACRO_STRING.
  54.           
  55.           
  56.           RECORD_MACRO(var s: string);                     [INP]
  57.  
  58.                This procedure allows the user to record a macro
  59.           string, up to 255 characters that will be invoked whenever
  60.           the CTRL-N key is pressed. The macro is stored in the
  61.           string variable S. To activate the macro capability, you
  62.           must place the macro into the string variable
  63.           "MACRO_STRING".
  64.  
  65.          
  66.           STACKED: string;                                 [---]
  67.  
  68.                The Procedure sread and sreadln can have stacked
  69.           commands which is when a user type something in like this:
  70.  
  71.                             "m;101;m;102;m;103;m;104"
  72.  
  73.                Notice the ";"'s throughout the example. well this is
  74.           a stacked command. the ";"'s indicate a seperate
  75.           operation. This allows the user to type in multiple
  76.           operations to preform on one line and not have to go
  77.           through each and every prompt of the door. This can be
  78.           very useful when used in combi- nation with the
  79.           Record_Macro command.
  80.  
  81.           MACRO_STR: string;                            [INF/CTL]
  82.  
  83.                 The contents of this variable are treated as a
  84.           macro. Whenever the user types a CTRL-N, the string will
  85.           be output. The string may be easily recorded with the
  86.           RECORD_MACRO procedure and displayed with the
  87.           DISPLAY_MACRO procedure.
  88.  
  89.  
  90.